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COPYRIGHT 1981 Atari # Inc* 



Coovright and right to make backup CQPies * On receipt of this computer program and 
asTOCiAted documentation tt»m j|oftii*»e)f ATARI grants to you a noneaiclysive iuaBnfB to execute 
the enclosed software and to make b^Kirkup or archival copies of tfie cxifi|:rirt»»r^p^^ for your 
personal use only, and only on the condition that all copies are conspicuously marked with the 
same copyright notices as appear on the original* This software is copyrighted* You are 
prohibited from reproducingi translatingi or distributing this software in any unauthorized 
manner* 
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, OVERVIEW 

MASHER is a ultility program to help you squeeze every last byte out of your 8K BASIC 
SQftwi^e^ It compresses your BASIC programs into a.s litle memory as possible by 

(1) Removing all unref^enced IffiMarkstatemw 

(2) Cianverting your most frequently used constants into variables 

(3) Packing together several short lines to ftrm longer ones 

Don't use line numbers 3 - 9 or assign variable names 0.0 - Q999 in your BASIC programs* MASHER 
uses these lines and variable names to define its variables that replace frequently used 
constants in your program* 

REQUIi^ ACCESSORIES 

32KRAM 

ATARI BASIC Language Cartridge 

ATARI 810 Disk Drive ' 

OPXIONAL SOFTWARE 

BASIC CROSS-REFERENCE UTIL3Tr IXWBFi 




ATARI Program Exchange (AFX) program tells you how many variables you've used in 
your program las w^ as praviding other information)* (Order No* APX-IOOO?) 

VARIABLE CHANGER 

This AFX program e^^Miatically shortens yoi^ program's variable MifieSi wMch often 
further reduces the program's memory requirements* It also tells you how many variables 
you've used in your program* (Order No* AFX-20012) 
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1* Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your computert 

2* Make sure your BASIC program to be compressed is in LIST format (rather than in SAVE 
format)* See page 10 of the BASIC Reference Manual or see the Disk Operating System 
Reference Manual for information about LIST format* 

3* Turn on your disk drive and insert the MASHER diskette* 

4* Power up your computer and turn on your video screen* 

5* At the READY prompt, type RUN "DIMASHER" and press the RETURN key* If you're using more 
than one disk drive, remember to follow the device initial (D) with the number of the drive 
containing the MASHER diskette (e*g*f RUN "D2:MASHER" for disk drive two)* The program will 

load into RAM and start* The first display screen will be the COPYRIGHT 1981 ATARI notice* 

6* If youVe using just one disk drive, remove the HASHER diskette and insert your BASIC 
program to be compressed* 
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SETTING UP 

You use MASHER by responding to three prompted questions* 

1 COMPLETE INPUT FILE NAME? 

Type in the complete n«fne of tte f ile in Ul^ format containing your BASIC program* Use 

the format • ' 

D ♦ f i 1 ena«# ♦ «Kt 

where "D" is the device initial^ "filename" stands for the name of your file (use 

upper case)f and "^ext" is the extender^ if yqu used one* An exaiiple is 

DtADDRESS*BAS « If you're using more tha^ one disk dirivet reiiiember to specif y tta miller 

of the drive containing your file (e.g*, D2JADDRESS*BAS for disk drive two)* 

2 COl(ff>LETE OUTPUT FILE 

Using the format described in prompt 1, type the complete file name under which you want 
MASHER to store your compressed program in LIST format* Your output file must have a 
differeiit name than ywr ir^ 

3 NUMBER OF VARIABLES USED IN SOURCE PROGRAM? 

Type in the number of viuriabtes used in your input filet MASHERuses this information to 
determine how fiieny constants it his rmm to dtf^e as variabiM BASIC is 

limited to 123)* 

You can determine this number in three ways* 

(1) Count them! This method is fine if you don't mind spending the time* Increment 
your count by a small amount as a "fudge factor" against your having missed a few* 

(2) OuMSf For small programs» guessing is acceptable^ If you guess too hight MASHER 
might not compress your program as well as it might have with the true count* If you 
guess too lowt MASHER might unknowlingy exceed BASIC'S 128-variable limit and your 
program will geniHrate an ERROR 4- (Tcki Many VariablMX when ymi run itr It's better 
to guess high* 

(3) Use the BASIC CROSS-REFERENCE UTILITY (XREF) or VARIALBE NAME CHANGER* available 
through APX« Both programs give you the mxMCjt variable asunt for yiaur prografiif 

MASHER then takes over and starts compressing your program^ 



MASHER displays the message 

PLEASE STAND BY 

for a short time* It then clears the video screen to go into "attract mode", which allows 
MASHER to run about 40 percent faster since the screen isn't interrupting the microprocessor* 

MASHER can take a long time* A small program might take only k few minutes to compress* but 
a large program can take hours! As long as the disk drive is read periodically, all is welL 
Take this opportunity to relax and browse through the latest APX software catalog for gift 
ideas — for yourself and others! 

When MASHER finishest it reactivates the video screen and displays the number of lines in your 
input and output files* 

EVALUATIMG THE RESULTS 

Occasionally, your output file might have more lines than does your input file* In these 
cases, check the amount of RAM used by each program before rejecting the compressed version* 
Because MASHER adds lines to redefine constantsr the line count might increase but the 
compressed program will still require less RAM to run* A compressed program is rarely, if 
ever, larger than your original BASIC program* 

Normally, MASHER saves between 5 and 60 percent of your program's original required RAM* The 
amount depends on your individual programming style* Programmers who use many remarks and 
single statement lines will save the greatest amount* In short, the more structured and 
easy-to-read your input file, the more MASHER can cgmpress! 




ERROR MESSAGE 



The error message 



SOURCE CODE ERRORt LA^T LXNEt 



II 



<last line re3d> 



occurs when a file contains some text that is illegal in BASIC (etg*! a line with no line 
number)* This «ror causes MASHER to abort. F» tt» prt^lem in your source prc^ram and rerun 
MASHER. 



MASHER is quite demanding of disk drives* Because a long program can take hours to compress» 
tven the best system might stumble* Try rerunning MASHER before throwing in the towel* 

MASHER can't resolve variable GOTOs (e*g*, GOTO Xlt €li«€fcyow iXM^i^PVtsad program if you usitf 
this kind of GOTO. 

||pGGESTIONS FOR TRACKING DOWN FAULTY PROGRAM EXECtniOH 

If you finii t*iat your compressecl program doesn't run correctly* check these points} 

(1) Did you leave lines 3-9 av«dSabl« f or M ASHER^t use? MAfflH^ 

lines to define its constants 

9 even if you use these lines as well. MASHER'S constant definitions will be 

overwrittent causing some strange errors^ 

(2) Did you leave variable names QO - Q999 for MASHER'S use? 

(3) Did you use a CLR statement anywhere in your program? This statement clears out 
MASHER'S QO - Q999 definitions, causing all sorts of problems! In most applications, CLR 
is unnecessary and you can safely eliminate it. If you include a CLR statement^ make sure 
your progwrn re--e3ii«irte» 

(4) Did you use computed line references (e.g., GOTO X)? If so, these may reference lines 
that don't exist anymore if MASHER merged the statements with other lines* One way to 
preserve ttese lines when running MASHER is to place a dummy reference to these lines at 
the beginning of your progr«m*^»r «KwnpUiJ 



20 ON I GOTO 



1500t2000,2100 



♦ 



60 GOTO X 



• 
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MASHER can save you a lot of RAM» but it's not the only method available to you as a 
programmer* Here are some other techniques* 

(1) Use strings instead of numeric arrays to store data* 

(2) Add two "Q" variables together to form a constant, rather than defining a new 
constant* For example, the constant I=Q2+Q5 takes less RAM than does the constant 1=7 
if you've already defined Q2 and Q5* 

(3) Use subroutines for common functions* 

(4) Recode parts of your BASIC program into machine language* 

(5) Reuse variables when they don't interfere with each other* The XREF programi 
available through APX# can help detect interference* 

(6) Use short variable names* The VARIABLE CHANGER program^ available through AFX, can 

help you change variable names in existing programs* 

(7) Chain in parts of your program from disk rather than maintaining your entire program 
in RAM* 

(8) Use the graphics mode requiring the least amount of RAM but is still suited to your 
application* For example^ Modes 1 and 2 require less RAM than does Mode 0* 

(9) POKE data into unused RAM areas instead of keeping data in arrays* Appendix D of the 
BASIC Reference Manual shows where some of these areas are* You can also use the 
printer and cassette buffers for data if you're not using these devices* 
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REVIEW FORM 



We're interested in your experiences with APX programs and documentation » both favorable and 

unfavorable* Many software authors are willing and eager to improve their programs if they know 
what users want* Andt of course, we want to know about any bugs that slipped by us, so that the 
software author can fix them* We also want to know whether our documentation is meeting your needs 
Tou are our best sourae for suggesting improveirwits! PlMse help by.tiikiiig m momenttQ fill in this 
review sheet ♦ Fold the sheet in tWrds and seal it SO that the address im the bot*em of the back 
becomes the envelope front* 



!• Name and APX number of program , 

2* If you have prcri^lfins using the program» please descri^^e them here* 



3* What do you espei^UMly like about this pri^ram? 



4* What do you think the prc^am's weaknesws are?-^ - 



5« How can the cataliig description be more acoirate and/cHr 



6* On a scale of 1 to 10, 1 being "poor" and 10 being "excellent"* please rate the following 
aspects of this program! , 

Easy to use 

User-oriented (e*g*f menus* prompts, clear language) 

Enjoyable 

Self-instructive h 

Useful (for non-game software) 

Imaginative graphics and sound 



7« Desoribe any technical errors you found in the user instructions (please give page numbers) 



8« Hhat did you especially like about the user instructions? 



9« Hhat revisions or additions would improve these instructions? 



« 



iO« On a scale of 1 to lOf 1 representing "poor" and 10 representing "excellent"i how would you 
rate the documentation and why? 



11» Other comments about the software or the user instructions* 



I I 
ISTAMPi 

I I 



ATARI Program Exchange 
P» O* Box 427 
155 Moffett Park Drive 
Sunnyvalet CA 94086 
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